home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / basic / qbflow.com / QBFLOW.DOC next >
Encoding:
Text File  |  1990-01-07  |  3.2 KB  |  73 lines
  1.                               QBFLOW
  2. This program shows the relationships between the main module and
  3. the SUB and FUNCTION procedures in a QuickBasic source file.
  4.  
  5. The source file must have been saved in TEXT format.
  6.  
  7. When starting QBFLOW, add the name of the source file as a
  8. command line parameter without the BAS extension. If you don't,
  9. the program will prompt you for the name of the file to analyze.
  10. Entering /? or ? as a parameter will give you a help screen
  11. showing the proper syntax.
  12.  
  13. Next the program asks for the destination of the output. Answer
  14. with either S, F or P for Screen, File or Printer. Screen sends
  15. all output to the screen and asks if you want to pause when the
  16. screen is full. Answer Y, N or A for Yes, No or Always. Yes will
  17. continue and ask again when the screen fills up, No will scroll
  18. continuously and Always will pause after every screen full
  19. without asking for this option.
  20.  
  21. File sends the output to a DOS file. You will be prompted to give
  22. the destination file name. Answer with the complete file
  23. specification, including extension and path if you want to store
  24. it elsewhere than the default path.
  25.  
  26. Printer sends the output to a printer connected to LPT1. The
  27. program does not check for valid output file names nor whether or
  28. not a printer is on-line!
  29.  
  30. The program then counts the number of declare statements and then
  31. stores the SUB and FUNCTION names in an array.
  32.  
  33. The first line of the source file must be a DECLARE statement and
  34. there must not be any breaks before the last DECLARE statement.
  35. The program stops counting when it reaches the first line which
  36. does not start with DECLARE.
  37.  
  38. Next each line of the source file is read and checked. If either
  39. the word SUB or FUNCTION is the first word then the following
  40. lines are part of a procedure. If one of the named SUBs or
  41. FUNCTIONs appears in the line then that procedure is being
  42. called. A count is kept of the total number of calls within each
  43. procedure.
  44.  
  45. When the program ends the total number of named procedures and
  46. the total number of calls in the source file are shown.
  47.  
  48. The output of QBFLOW starts with the module level code  and all
  49. of its calls in the order that they appear in the source file.
  50. Thus the first procedure called is listed first, then the second,
  51. the third etc. Next each SUB an FUNCTION is listed also with its
  52. called procedures. At the end of the module level code and each
  53. procedure the number of calls made are shown.
  54.  
  55. If the same procedure gets called more than once in one
  56. procedure, the order that they are called is shown. The total
  57. number of calls line will show how many times procedure calls
  58. were made in the source file.
  59.  
  60. See QBFLOW.FLO for a sample output using QBFLOW.BAS as the source
  61. file.
  62.  
  63. This program was written by me in order to help keep track of the
  64. calls I was making in a large program I was writing and the order
  65. in which they occurred. You are free to use QBFLOW for your own
  66. private use. I make no claims of accuracy nor for any damages
  67. that may result from its use or misuse. The program is offered
  68. AS-IS.
  69.  
  70. You can reach me: Martin van Kuilenburg on Compuserv 72261,2541
  71. Any comments, suggestions, hints etc. are welcome.
  72.  
  73.